home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-02 / p2c4os2.zip / DISTRIB / OS2 / README < prev    next >
Text File  |  1992-08-03  |  3KB  |  60 lines
  1.  
  2. This directory contains "p2c", a Pascal to C translator for OS/2 v 2.0.
  3.  
  4. "p2c"  Copyright 1989, 1990, 1991  Free Software Foundation, Inc.
  5.  
  6. Written and maintained by:   Dave Gillespie
  7.                  256-80 Caltech
  8.                  Pasadena CA 91125
  9.                  daveg@csvax.cs.caltech.edu, cit-vax!daveg
  10.  
  11. Ported to OS/2 by        :   Bernt Karasch
  12.                              Ruhr-Universitaet Bochum
  13.                              Institut fuer Mineralogie
  14.                              Universitaetsstrasse 150
  15.                              W-4630 Bochum 1 
  16.                              Federal Republic of Germany
  17.                              hermann.gies@ruba.rz.ruhr-uni-bochum.dbp.de
  18.  
  19.  
  20. This program is distributed under the terms of the GNU License Agreement.
  21. See the file src/COPYING for details.
  22.  
  23. The GNU License Agreement restrictions do _not_ apply to code generated
  24. by p2c, nor to the p2c run-time files "p2clib.c" and "p2c.h".
  25.  
  26.  
  27. The file "system.imp" contains declarations for "predefined" functions
  28. like "sqrt".  These generally have custom translation code in funcs.c.
  29. Functions with irregular syntaxes have their symbol table entries built
  30. directly in funcs.c; they do not appear here.  The default p2crc
  31. (\emx\p2c\p2crc) causes p2c to read system.imp at the beginning of every job.
  32.  
  33. The file "system.m2" contains declarations for predefined Modula-2
  34. functions.  It should be substituted for "system.imp" when translating
  35. Modula-2 programs.
  36.  
  37. The file "turbo.imp" contains declarations for all the Turbo Pascal
  38. standard units like dos and crt.  (These are very incomplete at
  39. present.)  The default p2crc (\emx\p2c\p2crc) causes p2c to read
  40. turbo.imp as soon as any Turbo standard unit is used.
  41.  
  42. The file "string.pas" implements the Oregon Software dynamic strings
  43. package.  These are translated pretty completely into native C strings
  44. using only the FuncMacro mechanism of p2c---no custom C code was
  45. written to support these functions.
  46.  
  47. NO WARRANTY:
  48.    The program in this directory was developed for internal use at
  49.    Caltech and thus absolutely no guarantee is made that the program
  50.    will compile or run on other systems or that it will produce correct
  51.    code.  P2c is _not_ a compiler, it is a translator; it strives to
  52.    produce correct code but reserves the right to sacrifice correctness
  53.    in extreme cases for readability in the general case.  P2c is designed
  54.    to be extended (see funcs.c, hpmods.c and citmods.c for examples), but
  55.    some of the main code is pretty messy since the translator has grown
  56.    considerably beyond its original planned scale.  Bug reports are
  57.    welcome at daveg@csvax.caltech.edu, but I may not have time to respond
  58.    to them immediately.  Suggestions are welcome, too!
  59.  
  60.